<!DOCTYPE html>
<html>
<head>
<meta charset="UTF-8">
</head>
<body>
<a name="top"></a>
<h1>Contents</h1>
<ul>
<li><a href="#about_this_app">About this app</a>
<li><a href="#window_list">Window list</a>
<li><a href="#notification">Notification</a>
<li><a href="#workspaces">Workspaces</a>
<li><a href="#control_widget">Control widget</a>
<li><a href="#shortcut">Shortcut</a>
<li><a href="#locale_and_tasker">Locale and Tasker</a>
<li><a href="#how_to_open_a_new_window">How to open a new window</a>
<li><a href="#how_to_close_a_window">How to close a window</a>
<li><a href="#how_to_delete_a_window">How to delete a window</a>
<li><a href="#how_to_hide_a_window">How to hide a window</a>
<li><a href="#how_to_show_a_hidden_window">How to show a hidden window</a>
<li><a href="#how_to_move_a_window">How to move a window</a>
<li><a href="#how_to_resize_a_window">How to resize a window</a>
<li><a href="#how_to_change_z_order">How to change z-order</a>
<li><a href="#how_to_iconify_a_window">How to iconify a window</a>
<li><a href="#how_to_restore_an_iconified_window">How to restore an iconified window</a>
<li><a href="#how_to_resize_title_bar">How to resize title bar</a>
<li><a href="#how_to_hide_title_bar">How to hide title bar</a>
<li><a href="#how_to_show_title_bar">How to show title bar again</a>
<li><a href="#how_to_show_notification">How to show notification</a>
<li><a href="#how_to_switch_workspaces">How to switch workspaces</a>
<li><a href="#how_to_show_a_window_in_multiple_workspaces">How to show a window in multiple workspaces</a>
<li><a href="#anchor">Anchor</a>
<li><a href="#donation">Donation</a>
<li><a href="#copyright_notice_and_disclaimer">Copyright notice and disclaimer</a>
</ul>

<hr>
<a name="about_this_app"></a>
<h1>About this app</h1>
<p>
This app, Widget Window, is a utility app to show widgets in floating windows.
The windows are floating on the screen
so that you can see and use widgets any time,
even when other apps are running.
<p>
<a href="#top">Back to top</a>

<hr>
<a name="window_list"></a>
<h1>Window list</h1>
<p>
When this app is launched, it displays the window list.
The list shows all windows including hidden ones.
If it is the first launch,
there are no windows and the list is empty.
Press the menu button and select 'new window' to open your first window.
<p>
See also:
<ul>
<li><a href="#how_to_open_a_new_window">How to open a new window</a>
</ul>
<p>
<a href="#top">Back to top</a>

<hr>
<a name="notification"></a>
<h1>Notification</h1>
<p>
Notification is a way for apps to show some information on the status bar.
Widget Window provides a useful control in the notification area.
It has a '+' button to open a hidden or new window and
number buttons to switch workspaces.
<p>
In addition,
notification has an ability to run a service in foreground state.
In Android, there are two states in which a service runs:
background state and foreground state.
A service running in background state is treated as less important and is easily killed by the system under memory pressure.
A service running in foreground state is treated as more important and is unlikely to be killed,
but the service must show a notification on the status bar to run in foreground state.
Widget Window runs in foreground state if 'Show notification' option is turned on.
Although you may want not to make the status bar full of notifications,
it is recommended for background apps to show them.
If you use shortcuts to control Widget Window by other apps,
you don't have to mind about this issue because the shortcut restarts the service as needed.
<p>
See also:
<ul>
<li><a href="#how_to_show_notification">How to show notification</a>
<li><a href="#shortcut">Shortcut</a>
</ul>
<p>
<a href="#top">Back to top</a>

<hr>
<a name="workspaces"></a>
<h1>Workspaces</h1>
<p>
Workspace is a group of windows.
There are 10 workspaces and you can switch between them.
If you switch from the workspace 1 to the workspace 2 for instance,
windows in the workspace 1 become hidden
and windows in the workspace 2 become visible.
A window can belong to multiple workspaces
so that important windows
(Widget Window Control widget for instance)
can be made to be always visible.
<p>
See also:
<ul>
<li><a href="#how_to_switch_workspaces">How to switch workspaces</a>
<li><a href="#how_to_show_a_window_in_multiple_workspaces">How to show a window in multiple workspaces</a>
</ul>
<p>
<a href="#top">Back to top</a>

<hr>
<a name="control_widget"></a>
<h1>Control widget</h1>
<p>
Widget Window provides its own widget called 'Widget Window Control.'
It has a '+' button to open a hidden or new window and
number buttons to switch workspaces.
<p>
This is an ordinal widget so that it can be put on the home screen.
Needless to say, Widget Window itself also can host the widget.
<p>
<a href="#top">Back to top</a>

<hr>
<a name="shortcut"></a>
<h1>Shortcut</h1>
<p>
Shortcut is an icon which can be put on the home screen.
Widget Window provides a shortcut to open a hidden or new window or to switch workspace.
You can also use other apps that support shortcut feature,
SwipePad for instance,
to control Widget Window.
<p>
<a href="#top">Back to top</a>

<hr>
<a name="locale_and_tasker"></a>
<h1>Locale and Tasker</h1>
<p>
Widget Window provides a plug-in for Locale and Tasker
to switch workspace and show/hide each window.
In Locale,
Widget Window is listed on 'PLUG-IN' section of 'Add Setting' menu.
Workspace menu is popped up when you choose Widget Window.
In Tasker,
Widget Window is listed on 'Plugin' category of 'Add Action' menu.
Workspace menu is popped up when you press the 'Edit' button.
<p>
<a href="#top">Back to top</a>

<hr>
<a name="how_to_open_a_new_window"></a>
<h1>How to open a new window</h1>
<ol>
<li>
Press the menu button to show the option menu.
<li>
Select 'New window.'
The list of installed widgets is displayed.
<li>
Select a widget you like.
<li>
If the widget has any options, it is displayed.
Select options you like.
<li>
New window with the widget opens.
</ol>
<p>
<a href="#top">Back to top</a>

<hr>
<a name="how_to_close_a_window"></a>
<h1>How to close a window</h1>
<p>
Did you mean:
<ul>
<li><a href="#how_to_delete_a_window">How to delete a window</a>
<li><a href="#how_to_hide_a_window">How to hide a window</a>
</ul>
<p>
<a href="#top">Back to top</a>

<hr>
<a name="how_to_delete_a_window"></a>
<h1>How to delete a window</h1>
<ol>
<li>
Select an item of the window list which you want to delete.
<li>
Select 'Delete window.'
The window is deleted.
</ol>
<p>
<a href="#top">Back to top</a>

<hr>
<a name="how_to_hide_a_window"></a>
<h1>How to hide a window</h1>
<ol>
<li>
Select an item of the window list which you want to show.
<li>
Select 'Hide window.'
The window becomes hidden.
</ol>
<p>
You can also tap the X button on the title bar to hide the window.
If the button is not on the title bar,
put a check mark on 'Show close button' check box
(turn the switch on if Android 4.x)
in the Settings screen.
<p>
<a href="#top">Back to top</a>

<hr>
<a name="how_to_show_a_hidden_window"></a>
<h1>How to show a hidden window</h1>
<ol>
<li>
Select an item of the window list which you want to show.
<li>
Select 'Show window.'
The window becomes visible again.
</ol>
<p>
You can also show a window via the notification area,
the control widget, shortcuts, Locale or Tasker.
<p>
See also:
<ul>
<li><a href="#how_to_show_notification">How to show notification</a>
<li><a href="#control_widget">Control widget</a>
<li><a href="#shortcut">Shortcut</a>
<li><a href="#locale_and_tasker">Locale and Tasker</a>
</ul>
<p>
<a href="#top">Back to top</a>

<hr>
<a name="how_to_move_a_window"></a>
<h1>How to move a window</h1>
<ol>
<li>
Drag the title bar of the window.
The window moves as you drag.
</ol>
<p>
<a href="#top">Back to top</a>

<hr>
<a name="how_to_resize_a_window"></a>
<h1>How to resize a window</h1>
<ol>
<li>
Long-press the title bar of the window.
Border appears around the window.
<li>
Drag the border.
The window changes its size as you drag.
<li>
Touch outside of the border to finish resizing.
</ol>
<p>
<a href="#top">Back to top</a>

<hr>
<a name="how_to_change_z_order"></a>
<h1>How to change z-order</h1>
<ol>
<li>
Select an item of the window list which you want to bring to front.
<li>
Select 'Bring to front.'
The window is brought to front.
</ol>
<p>
<a href="#top">Back to top</a>

<hr>
<a name="how_to_iconify_a_window"></a>
<h1>How to iconify a window</h1>
<ol>
<li>
Tap the triangle-shaped button on the title bar of the window.
The window becomes an icon.
</ol>
<p>
If the button is not on the title bar,
put a check mark on 'Show iconify button' check box
(turn the switch on if Android 4.x)
in the Settings screen.
<p>
<a href="#top">Back to top</a>

<hr>
<a name="how_to_restore_an_iconified_window"></a>
<h1>How to restore an iconified window</h1>
<ol>
<li>
Tap the iconified window.
The window is restored.
</ol>
<p>
<a href="#top">Back to top</a>

<hr>
<a name="how_to_resize_title_bar"></a>
<h1>How to resize title bar</h1>
<ol>
<li>
Press the menu button to show the option menu.
<li>
Select 'Settings.'
The Settings screen is displayed.
<li>
Select 'Title bar size.'
The size menu is popped up.
<li>
Select a size you like.
Title bar is resized.
</ol>
<p>
<a href="#top">Back to top</a>

<hr>
<a name="how_to_hide_title_bar"></a>
<h1>How to hide title bar</h1>
<ol>
<li>
Tap the rectangular-shaped button on the title bar of the window.
The title bar becomes hidden.
</ol>
<p>
However, the button is turned off by default.
So you must turn it on first.
<ol>
<li>
Press the menu button to show the option menu.
<li>
Select 'Settings.'
The Settings screen is displayed.
<li>
Put a check mark on 'Show hide-title-bar button' check box
(turn the switch on if Android 4.x).
The button appears on the title bar.
</ol>
<p>
See also:
<ul>
<li><a href="#how_to_show_title_bar">How to show title bar again</a>
</ul>
<p>
<a href="#top">Back to top</a>

<hr>
<a name="how_to_show_title_bar"></a>
<h1>How to show title bar again</h1>
<ol>
<li>
Long-press the widget.
The title bar comes back.
</ol>
<p>
<a href="#top">Back to top</a>

<hr>
<a name="how_to_show_notification"></a>
<h1>How to show notification</h1>
<ol>
<li>
Press the menu button to show the option menu.
<li>
Select 'Settings.'
The Settings screen is displayed.
<li>
Put a check mark on 'Show notification'
(turn the switch on if Android 4.x).
A notification icon appears on the status bar.
<li>
Pull the status bar down
(or tap the icon if tablet)
to show the notification and control buttons in it.
</ol>
<p>
<a href="#top">Back to top</a>

<hr>
<a name="how_to_switch_workspaces"></a>
<h1>How to switch workspaces</h1>
<ol>
<li>
Press the menu button to show the option menu.
<li>
Select 'Workspaces.'
The workspace submenu is displayed.
<li>
Select a workspace you want to switch to.
</ol>
<p>
You can also switch workspaces via the notification area,
the control widget, shortcuts, Locale or Tasker.
<p>
See also:
<ul>
<li><a href="#how_to_show_notification">How to show notification</a>
<li><a href="#control_widget">Control widget</a>
<li><a href="#shortcut">Shortcut</a>
<li><a href="#locale_and_tasker">Locale and Tasker</a>
</ul>
<p>
<a href="#top">Back to top</a>

<hr>
<a name="how_to_show_a_window_in_multiple_workspaces"></a>
<h1>How to show a window in multiple workspaces</h1>
<ol>
<li>Do
<a href="#how_to_show_a_hidden_window">how to show a hidden window</a>
in each workspace.
</ol>
<p>
<a href="#top">Back to top</a>

<hr>
<a name="anchor"></a>
<h1>Anchor</h1>
<p>
Anchor is a feature to keep positions of windows and icons
relative to a certain reference point
when the screen orientation is changed.
By default
windows and icons move proportionally to the size of the screen
when the orientation is changed.
If anchor is set to lower left,
windows and icons keep relative positions to
the lower left corner of the screen.
Anchor can be set to the
upper left, upper right, lower left or lower right
corner of the screen.
<p>
To change the anchor setting:
<ol>
<li>
Press the menu button to show the option menu.
<li>
Select 'Settings.'
The Settings screen is displayed.
<li>
Select 'Anchor.'
The anchor menu is displayed.
<li>
Select an option you like.
</ol>
<p>
<a href="#top">Back to top</a>

<hr>
<a name="donation"></a>
<h1>Donation</h1>
<p>
Donation via in-app purchase is experimentally implemented.
If you love this app, please consider a donation to support me.
Note that the donation provides no additional features.
No features are restricted even if you don't donate.
Thank you.
<p>
<a href="#top">Back to top</a>

<hr>
<a name="copyright_notice_and_disclaimer"></a>
<h1>Copyright notice and disclaimer</h1>
<p>
Copyright &copy; 2012-2013, yuno. All rights reserved.
<p>
Redistribution and use in source and binary forms, with or without
modification, are permitted provided that the following conditions are met:
<ol>
<li>Redistributions of source code must retain the above copyright notice,
this list of conditions and the following disclaimer.
<li>Redistributions in binary form must reproduce the above copyright notice,
this list of conditions and the following disclaimer in the documentation
and/or other materials provided with the distribution.
<li>Neither the name of the copyright holder nor the names of contributors
may be used to endorse or promote products derived from this software
without specific prior written permission.
</ol>
<p>
THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
POSSIBILITY OF SUCH DAMAGE.

<hr>
<h2>Other notices</h2>
<p>
This software includes works of the Android Open Source Project
and the Google Play Billing Library
licensed under the Apache License, Version 2.0.
<ul>
<li><a href="apache_license_v2.html">Apache License, Version 2.0</a>
<li><a href="aosp_notice.html">NOTICE</a>
</ul>

<hr>
<h2>Source code</h2>
<p>
Source code of this software is available on the following website.
<ul>
<li><a href="http://code.google.com/p/widgetwindow/">http://code.google.com/p/widgetwindow/</a>
</ul>

<p>
<a href="#top">Back to top</a>

</body>
</html>
